home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / ethers.z / ethers
Encoding:
Text File  |  2002-10-03  |  4.4 KB  |  64 lines
  1.  
  2.  
  3.  
  4. EEEETTTTHHHHEEEERRRRSSSS((((3333YYYY))))                                                          EEEETTTTHHHHEEEERRRRSSSS((((3333YYYY))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ether_ntoa, ether_aton, ether_ntohost, ether_hostton, ether_line -
  10.      ethernet address mapping operations
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ssssttttrrrruuuucccctttt eeeetttthhhheeeerrrr____aaaaddddddddrrrr {{{{
  14.          uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr  eeeetttthhhheeeerrrr____aaaaddddddddrrrr____oooocccctttteeeetttt[[[[6666]]]];;;;
  15.      }}}};;;;
  16.      cccchhhhaaaarrrr ****eeeetttthhhheeeerrrr____nnnnttttooooaaaa((((ssssttttrrrruuuucccctttt eeeetttthhhheeeerrrr____aaaaddddddddrrrr ****eeee))));;;;
  17.      ssssttttrrrruuuucccctttt eeeetttthhhheeeerrrr____aaaaddddddddrrrr ****eeeetttthhhheeeerrrr____aaaattttoooonnnn((((cccchhhhaaaarrrr ****ssss))));;;;
  18.      iiiinnnntttt eeeetttthhhheeeerrrr____nnnnttttoooohhhhoooosssstttt((((cccchhhhaaaarrrr ****hhhhoooossssttttnnnnaaaammmmeeee,,,, ssssttttrrrruuuucccctttt eeeetttthhhheeeerrrr____aaaaddddddddrrrr ****eeee))));;;;
  19.      iiiinnnntttt eeeetttthhhheeeerrrr____hhhhoooossssttttttttoooonnnn((((cccchhhhaaaarrrr ****hhhhoooossssttttnnnnaaaammmmeeee,,,, ssssttttrrrruuuucccctttt eeeetttthhhheeeerrrr____aaaaddddddddrrrr ****eeee))));;;;
  20.      iiiinnnntttt eeeetttthhhheeeerrrr____lllliiiinnnneeee((((cccchhhhaaaarrrr ****llll,,,, ssssttttrrrruuuucccctttt eeeetttthhhheeeerrrr____aaaaddddddddrrrr ****eeee,,,, cccchhhhaaaarrrr ****hhhhoooossssttttnnnnaaaammmmeeee))))
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      These routines are useful for mapping 48 bit ethernet numbers to their
  24.      ASCII representations or their corresponding host names, and vice versa.
  25.  
  26.      The function _e_t_h_e_r__n_t_o_a converts a 48-bit ethernet number pointed to by _e
  27.      to its standard ACSII representation; it returns a pointer to the ASCII
  28.      string.  The representation is of the form: ``x:x:x:x:x:x'' where _x is a
  29.      hexadecimal number between 0 and ff.  The function _e_t_h_e_r__a_t_o_n converts an
  30.      ASCII string in the standard representation back to a 48 bit ethernet
  31.      number;  the function returns NULL if the string cannot be scanned
  32.      successfully.
  33.  
  34.      The function _e_t_h_e_r__n_t_o_h_o_s_t maps an ethernet number (pointed to by _e) to
  35.      its associated hostname.  The string pointed to by _h_o_s_t_n_a_m_e must be long
  36.      enough to hold the hostname and a null character.  The function returns
  37.      zero upon success and non-zero upon failure.  Inversely, the function
  38.      _e_t_h_e_r__h_o_s_t_t_o_n maps a hostname string to its corresponding ethernet
  39.      number; the function modifies the ethernet number pointed to by _e.  The
  40.      function also returns zero upon success and non-zero upon failure.
  41.  
  42.      The function _e_t_h_e_r__l_i_n_e scans a line (pointed to by _l) and sets the
  43.      hostname and the ethernet number (pointed to by _e).  The string pointed
  44.      to by _h_o_s_t_n_a_m_e must be long enough to hold the hostname and a null
  45.      character.  The function returns zero upon success and non-zero upon
  46.      failure.  The format of the scanned line is described by _e_t_h_e_r_s(4).
  47.  
  48. FFFFIIIILLLLEEEESSSS
  49.      /etc/ethers    (or the NIS maps ethers.byaddr and ethers.byname)
  50.  
  51. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.      ethers(4) of these functions.
  53.  
  54.  
  55.  
  56.  
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.